# tap.requirePrivacyAuthorize(Object object)

以 Promise 风格调用:不支持

# 功能描述

模拟隐私接口调用,并触发隐私弹窗逻辑。隐私合规开发指南详情可见 《小游戏隐私合规开发指南》

# 参数

# Object object

属性类型默认值必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

# 具体说明:

  1. 调用 tap.requirePrivacyAuthorize() 时:
    1. 如果用户之前已经同意过隐私授权,会立即返回success回调,不会触发 tap.onNeedPrivacyAuthorization 事件。
    1. 如果用户之前没有授权过,并且开发者注册了 tap.onNeedPrivacyAuthorization() 事件监听,就会立即触发 tap.onNeedPrivacyAuthorization 事件,然后开发者在 onNeedPrivacyAuthorization 回调中弹出自定义隐私授权弹窗,用户点了同意后开发者调用 tap.onNeedPrivacyAuthorization 的回调接口 resolve({ event: 'agree' }),会触发 requirePrivacyAuthorize 的 success 回调。用户点击拒绝授权后开发者调用 tap.onNeedPrivacyAuthorization 的回调接口 resolve({ event: 'disagree' }) 的话,会触发 requirePrivacyAuthorize 的 fail 回调。
    1. 如果用户之前没有授权过,并且开发者没有注册 tap.onNeedPrivacyAuthorization() 事件监听,就会立即弹出平台提供的统一隐私授权弹窗,用户点了同意之后,会触发 requirePrivacyAuthorize 的 success 回调,用户点了拒绝后会触发 requirePrivacyAuthorize 的 fail 回调。
    1. 基于上述特性,开发者可以在调用任何真实隐私接口之前调用 tap.requirePrivacyAuthorize 接口来模拟隐私接口调用,并触发隐私弹窗(包括自定义弹窗或平台弹窗)逻辑。
  1. 一定要调用 tap.requirePrivacyAuthorize 接口吗?
  • 不是,tap.requirePrivacyAuthorize 只是一个辅助接口,可以根据实际情况选择使用。当开发者希望在调用隐私接口之前就主动弹出隐私弹窗时,就可以使用这个接口。

# 示例代码

tap.requirePrivacyAuthorize({
  success: () => {
    // 用户同意授权
    // runGame() 继续游戏逻辑
  },
  fail: () => {}, // 用户拒绝授权
  complete: () => {}
})